3D Graphics Programming with QuickDraw 3D 1.5.4

Pixmap Texture Objects

Labels

ASCII: PixmapTexture
Binary: txpm (= 0x7478706D )

Endian TypeS



 
BigEndian           0x00000000

LittleEndian        0x00000001

Constant descriptions

BigEndian: Packing is to be done in a big-endian manner.
LittleEndian: Packing is to be done in a little-endian manner.

Pixel TypeS



 
RGB8                0x00000000

RGB16               0x00000001

RGB24               0x00000002

RGB32               0x00000003

Constant descriptions

RGB8: 8 bits are devoted to each pixel in the pixmap.
RGB16: 16 bits are devoted to each pixel in the pixmap.
RGB24: 24 bits are devoted to each pixel in the pixmap.
RGB32: 32 bits are devoted to each pixel in the pixmap.

Data Format



 
Uns32               width

Uns32               height

Uns32               rowBytes

Uns32               pixelSize

PixelTypeEnum       pixelType

EndianEnum          bitOrder

EndianEnum          byteOrder

RawData             image[rowBytes * height]

width: The width of the pixmap. The value in this field must be greater than 0.
height: The height of the pixmap. The value in this field must be greater than 0.
rowBytes: The number of bytes in a row of the pixmap. The value in this field cannot be less than the product of the values in the width and pixelSize fields.
pixelSize: The size of each pixel in the pixmap. The value in this field must be greater than 0 and less than 32.
pixelType: The type of the pixels of the pixmap:; 0x00000000 = RGB32 0x00000001 = ARGB32 0x00000010 = RGB16 0x00000011 = ARGB16
bitOrder: The order in which the bits in a byte are addressed. This field must contain one of the constants BigEndian or LittleEndian .
byteOrder: The order in which the bytes in a word are addressed. This field must contain one of the constants BigEndian or LittleEndian .
image[]: The array that defines the pixmap.

Data Size

28 + rowBytes * height + padding

Description

A pixmap texture object is a generic method of transferring pixmap data that is used in conjunction with a texture shader.

Parent Hierarchy

Shared, texture.

Parent Objects

Texture shader. A pixmap texture object sometimes, but not always, has a parent object.

Child Objects

None.

Example



 
PixmapTexture (

    256 256                             # width/height

    128                                 # rowBytes

    32                                  # pixelSize

    RGB24

    BigEndian BigEndian

    0x00123232...

    0x...

)